home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / mint / mintmant / pkill.txt < prev    next >
Text File  |  1992-03-24  |  2KB  |  64 lines
  1. Pkill(2)                  Oct. 1, 1991                   Pkill(2)
  2.  
  3.  
  4.  
  5. NAME
  6.      Pkill - send a signal to a process
  7.  
  8. SYNOPSIS
  9.      #include <signal.h>
  10.  
  11.      WORD Pkill( WORD pid, WORD sig);
  12.  
  13. DESCRIPTION
  14.      Pkill sends the signal described  by  sig  to  one  or  more
  15.      processes, as follows:
  16.  
  17.      If pid is a positive number, then the signal is sent to  the
  18.      process with that process id.
  19.  
  20.      If pid is 0, the signal is sent to all members of  the  pro-
  21.      cess  group of the calling process (i.e. all processes which
  22.      have the same  process  group  number).  This  includes,  of
  23.      course, the calling process itself.
  24.  
  25.      If pid is less than 0, the signal is sent to  all  processes
  26.      with process group number -pid.
  27.  
  28. RETURNS
  29.      0 if successful. Note that if the current process is a reci-
  30.      pient of the signal, the Pkill call may not return at all if
  31.      the process is killed.
  32.  
  33.      ERANGE if sig is not a valid signal.
  34.  
  35.      EFILNF if pid
  36.       > 0 and the indicated process has terminated  or  does  not
  37.      exist, or if pid
  38.       < 0 and there are no processes in the corresponding process
  39.      group.
  40.  
  41.      EACCDN if pid > 0, the sending  process  does  not  have  an
  42.      effective user id of 0, and the recipient process has a dif-
  43.      ferent user id from the sending process.
  44.  
  45. SEE ALSO
  46.      Psetpgrp(2), Psignal(2)
  47.  
  48. BUGS
  49.      The user id checks should also  be  performed  when  sending
  50.      signals  to  process  groups.  Do  not  rely  on the lack of
  51.      checks, as this will be corrected at some point.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 0.9   Last change: MiNT Programmer's Manual             1
  61.  
  62.  
  63.  
  64.